home *** CD-ROM | disk | FTP | other *** search
/ Aminet 52 / Aminet 52 (2002)(GTI - Schatztruhe)[!][Dec 2002].iso / Aminet / dev / c / GetCRC.lha / GetCRC.readme < prev   
Text File  |  2002-10-13  |  4KB  |  87 lines
  1. Short:    V1.17 calculates different checksums
  2. Author:   stoecker@epost.de (Dirk Stoecker)
  3. Uploader: stoecker@epost.de (Dirk Stoecker)
  4. Version:  1.17
  5. Type:     dev/c
  6.  
  7. This program has 2 aims. First it allows to calculate different types
  8. of checksums including CRC and much other types and thus allows to
  9. identify a given checksum. Second its source code shows how to create
  10. these checksums, so they can be used in own projects.
  11.  
  12. It is plain and portable ANSI-C code. The program is called like
  13. "GetCRC <filename>" and prints the resulting checksums of this file.
  14.  
  15. Text modes aren't supported, but it always uses binary mode. The file
  16. must fit completely in memory. These are no restrictions to the
  17. algorithms, but are restrictions of using all of them in one program.
  18.  
  19. When choosing own algorithms, I suggest usage of "CRC-32 2", which
  20. is one of the reliable standard algorithms.
  21.  
  22. In the output the lines with (M/I) always have two numbers, where
  23. the first is Motorola byte ordering and the second Intel byte
  24. ordering. The Word and Longword checksums can't be calculated, if the
  25. file size isn't a multiple of 2 or 4. GetCRC calculates the checksum
  26. of the largest part, which is such an multiple and prints the
  27. additional bytes after the checksum. Depending on the checksum generator
  28. such bytes are either ignored, added to the higher bytes or added to
  29. the lower bytes of the result.
  30.  
  31. Here is the list of currently supported checksums. It also includes
  32. a list, where these are used. Tell me other places, so I may update
  33. this list. Send me new algorithms, source comments, better or different
  34. calculation methods, ...
  35.  
  36. CRC-16 1          : PCompress2, Arc, DMS, ProPack, LhA, Zoo, Shrink
  37. CRC-16 2          : CCITT, XModem, LU
  38. CRC-16 3          : Donald Kindred's CRC
  39. CRC-16 4          : old Zoom, CompDisk
  40. CRC-32 1          : Olaf Barthel's CRC, PCompress, Zoom 5, LhPak
  41. CRC-32 2          : Zip, GZip, LZX, RAR, Arj
  42. CRC-32 3          : Brik (Binary mode), Ace
  43. CRC-32 4          : GPatch
  44. CRC-32 5          : BZip2
  45. CRC-32 6          : BZip2 inverted
  46. CHS-16 1          : PowerPacker Passwords
  47. CHS-32 1M (WRAP)  : Olaf Barthel's CRC, Bootblock of OFS/FFS
  48. CHS-32 1I         : 
  49. CHS-32 2          : LightFileSystem
  50. EOR Byte          : 
  51. EOR Word (M/I)    : 
  52. EOR Long (M/I)    : ByteKiller, RSI-Packer
  53. Sum Byte Signed   : 
  54. Sum Byte Unsigned : SQ
  55. Sum Word Si (M/I) : 
  56. Sum Word Un (M/I) : 
  57. Sum Long M      : Root-, Bitmap-, File-, Datablock of OFS/FFS
  58. Sum Long I        : 
  59. md4sum            : EDonkey, Samba
  60. md5sum            : 
  61.  
  62. GetCRC maybe used to calculate only one CRC and only print this one.
  63. This is done by passing a number as 3rd argument. Currently only the
  64. CRC's and checksums are supported:
  65.  
  66.   CRC-16 x: 161, 162, 163, 164
  67.   CRC-32 x: 321, 322, 323, 324, 325, 326
  68.   CHS-16 x: 401
  69.   CHS-32 x: 5010, 5011, 502
  70.  
  71. The result is the checksum printed to output without carriage return
  72. or anything else. This maybe used in scripts, with pipes and ...
  73.  
  74. Use this tool as you want, but WITHOUT ANY WARRANTY!
  75.  
  76. Contact me at:
  77.  
  78. *********************************************************************
  79. * snail-mail:                  * e-mail:                            *
  80. *   Dirk Stoecker              *   stoecker@epost.de                *
  81. *   Geschwister-Scholl-Str. 10 *   dirk@dstoecker.de                *
  82. *   01877 Bischofswerda        * world wide web:                    *
  83. *   GERMANY                    *   http://www.dstoecker.de/         *
  84. * phone:                       * pgp key:                           *
  85. *   GERMANY +49 (0)3594/706666 *   get from WWW pages or keyservers *
  86. *********************************************************************
  87.